home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / tapedr43.zip / TAPE43.DOC < prev    next >
Text File  |  1993-04-12  |  16KB  |  386 lines
  1.  
  2.                                 T A P E  D O O R
  3.                                  Version 4.3 CMS
  4.  
  5.                         A BBS Door for Remote Tape Access
  6.                          A Utility for Local Tape Access
  7.  
  8.                             Copyright (c) 1990-1993
  9.                                 by Ray Tracey
  10.                              All rights reserved.
  11.  
  12.  
  13.                                 Support board is:
  14.  
  15.                                  The U.S.A BBS
  16.                            508-949-6421 (USR-HST V42)
  17.  
  18.  
  19.                                    Warranty
  20.  
  21.     This product is provided "as is" without warranty of any kind. The entire
  22.     risk as to the results and  performance of the program is assumed by you.
  23.     Furthermore, the  author does  not warrant, guarantee, or  make any  other
  24.     representations regarding  the use of,  or the  results of the use of the
  25.     program,  and you  rely on the  program and  results  solely at  your own
  26.     risk.  The author  cannot and  will not accept  responsibility for system
  27.     damage, loss of profit, or any other special, consequential or incidental 
  28.     damages  resulting  from  the  use  or  inability  to  use this  product.
  29.  
  30.                                    Copyright
  31.  
  32.     TAPE DOOR Copyright (c) 1990-93 by  Ray Tracey  is being distributed as
  33.     Shareware. Under this concept you may use the  SHAREWARE  (unregistered)
  34.     version for a reasonable period of  time for evaluation  after which you
  35.     must either register your copy or discontinue  usage.
  36.  
  37.  
  38.                                  Distribution
  39.  
  40.     You  are encouraged to  distribute TAPEDOOR  provided that all files
  41.     contained in the archive are distributed in their original and
  42.     unmodified state.
  43.  
  44.                                   Description
  45.     
  46.     TAPEDOOR is a Remote/Local library Access door for Colorado Tape Drives
  47.     That will Access a tape drive via a menuing system and restore requested
  48.     files or volumes from a remote location.
  49.  
  50.     REMOTE:
  51.     systems that are compatible with PCBOARD.SYS, USERS.SYS, DOOR.SYS,
  52.     CALLINFO.BBS, USERINFO.DAT, SFDOORS.DAT, GTUSER.DAT, TRIBBS.SYS, 
  53.     CHAIN.TXT or DORINFOx.DEF for interfacing to the BBS.
  54.  
  55.     LOCAL:
  56.     ANY Dos Base System.
  57.  
  58.          
  59.                                  Features               
  60.  
  61.  Fossil Driver Support
  62. ---------------------
  63.     TapeDoor supports the use of Fossil drivers.  To tell your Door to use
  64.     the Fossil  driver instead of the  standard COM ports, just put /FD on
  65.     the command line when running the door. For example:
  66.  
  67.      MYDOOR MYDOOR.CFG /FD
  68.  
  69.      indicates  that a Fossil driver is  present and should be used. If no
  70.      Fossil driver is detected, TapeDoor will print a message to that effect
  71.      and exit the door gracefully.
  72.  
  73. Environment Variables
  74. ---------------------
  75.      TapeDoor supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  76.      COM2/COM4 = IRQ3. If  you wish to use a non-standard IRQ,  add the IRQ
  77.      number  after the configuration  filename. Let's assume  your Door  is
  78.      called FOOBAR and you want to use COM1 and IRQ5. The command line
  79.      passed to your Door would be:
  80.  
  81.      FOOBAR FOOBAR.CFG /5  or FOOBAR FOOBAR.CFG /%IRQ%  for the environment
  82.      variable. The /5 tells  TapeDoor to use IRQ5  rather than the standard
  83.      IRQ4 that is normally used with COM1. No /x parameter is needed for the
  84.      standard IRQ's.
  85.  
  86.      When specifying  the location of the  system file  on line  1 of  the
  87.      DOORS.CFG  file, you may  use the environment  variables %pcbdrive%,
  88.      %pcbdir%, %pcbnode%, and %wcnodeid%. Some examples:
  89.  
  90.      PCBoard:
  91.      USERS.SYS in C:\PCB         - %pcbdrive%%pcbdir%\USERS.SYS
  92.      USERS.SYS in C:\PCB\NODE1   - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  93.  
  94.      Wildcat!:
  95.      USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  96.  
  97.      Non-PCBoard  systems may use the  PCB environment variables  by setting
  98.      them  in either  AUTOEXEC.BAT or  in the batch that runs  the door. For
  99.  
  100.      example:
  101.      SET PCBDRIVE=C:
  102.      SET PCBDIR=\BBSDIR
  103.      SET PCBNODE=1
  104.   
  105.   - Hard Disk Checking, Tape Door Will check to make sure you have the space
  106.     required to restore a file before allow a restore.
  107.  
  108.   - User Byte Checking, Tape Door Will check the requested file size against
  109.     the users  bytes left before restoring their requested file. this option
  110.     will only work if the door is running of 1 of the 4 bbs types.
  111.  
  112.     PCBOARD.SYS, USERS.SYS, DOOR.SYS <52 LINE> OR CALLINFO.BBS
  113.  
  114.     if you are using and bbs that does not make or use one of the files, try
  115.     and convert your current bbs's system file to one of the above then test
  116.     the door. Line  8 of the config file will set this option on or off.
  117.  
  118.   - Exist, Tape Door  Will check the  restore path for the  existence of the
  119.     requested file, if the file was previously restored the user is told that
  120.     file exists on the Hard Drive and to exit the door to download.
  121.  
  122.   - Space Bar, when pressed while most menus are being displayed will stop
  123.     the display and prompt for the next command.
  124.    
  125.   - Keyboard time out after 3 min.
  126.   - Carrier detection
  127.   - Chat mode
  128.   - and much, much more!!.
  129.    
  130.  
  131.                                 MISCELLANEOUS NOTES
  132.                                 ===================
  133.  
  134.   TapeDoor requires DOS 3.x and up since all files are opened in SHARED mode.
  135.  
  136.   When using PCBOARD.SYS, TapeDoor also accesses the USERS file.
  137.  
  138.   When using USERS.SYS, TapeDoor also accesses  PCBOARD.SYS, PCBOARD.DAT and
  139.   the USERS file.
  140.  
  141.   The DOOR.SYS used by TapeDoor is the standard 52 line GAP (tm) file.
  142.  
  143.   The CALLINFO.BBS used by TapeDoor currently contains 36 lines.
  144.  
  145.   When creating menus for tapedoor save the files in block mode.
  146.  
  147.  
  148. Getting Started
  149. ----------------
  150.  
  151.   I will attempt to explain how to install Tape Door Step By Step if you
  152.   Haven't printed this doc, i suggest you do!.
  153.  
  154.                                  ( 1 )
  155.  
  156.   Be sure  your TAPE software is in  path or in  tapedoors  directory,
  157.   Tape Door  doesn't restore the  file!, Your Colorado software will!.
  158.  
  159.  
  160.                                  ( 2 )
  161.  
  162.    Preparer  a tape for tape door. The  best way is to backup  file areas
  163.    straight from the bbs. or use and existing backup for the door.
  164.  
  165.    Tape door has to ways of restoring files. the first is to restore files
  166.    By FileName. By Restoring Files By name a user is prompted for a filename
  167.    to be restored,  tape door will then  find the file and  restore it for
  168.    download.
  169.  
  170.    The Second method is to restore files by Volume, the user will be prompted
  171.    for a volume number to restore and the WHOLE volume will be restored.
  172.      
  173.    Restoring files by filename is the best way and is somewhat like the same
  174.    way your bbs's file system runs.
  175.   
  176.    we will be needing the total volumes on your tape so remember how many
  177.    volumes you tape has.
  178.      
  179.                                   ( 3 )
  180.  
  181.    Once you have prepared your tape the next step is to run 43SEARCH.BAT
  182.    to ease the use of your TAPE SEARCH command, What 43search will do is
  183.    get  a file listing of your tape and store this info in a file called
  184.    TAPELIST.LST tapedoor will not run if this file does not exist.
  185.  
  186.    For more info on using the batch file with the CMD utility  view  the
  187.    43search.bat file.
  188.  
  189.    this is the colorado command line needed to make tapelist.lst
  190.    examp: TAPE SEARCH \*.* /S /V=%1 >> TAPELIST.LST
  191.  
  192.    replacing the %1 with the desired volume number to search, repeat this
  193.    operation till you have all the volumes you want in TAPELIST.LST
  194.  
  195.                                   ( 4 )
  196.  
  197.    TAPELIST.LST now needs to be cleaned up, TAPEFIX.EXE will strip out
  198.    any unwanted text and separate the volumes by some simple * codes
  199.    tapefix may be run on tapelist.lst at any time for updating. just
  200.    run command line in step 3 then run tapefix.exe you may wish to edit
  201.    tapelist with a text editor?, to do so is easy.
  202.  
  203.    the start of each volume will begin with 12 *'s and Volume # then number
  204.    ************Volume # 1
  205.                ^^^^^^^^^^ this text can be found in the file, just delete
  206.                            any unwanted text and add the 12 *'s
  207.  
  208.    the next line will be the size of this volume
  209.    ************10,456,093
  210.                ^^^^^^^^^^ This text can also be found.
  211.       
  212.    That's it!, remove all lines that contain <DIR>
  213.  
  214.    This is what it should look like.
  215.  
  216. ************Volume #  1    
  217. ************238,270
  218. QMENU1_6.ZIP       166,776  05-04-1991  10:15 PM \PCB\MAIN\TAPE_DRV\
  219. SFLY10.ZIP          71,494  05-04-1991  10:15 PM \PCB\MAIN\TAPE_DRV\
  220. ************Volume #  2    
  221. ************199,989
  222. 3DMENU11.ZIP        39,567  10-09-1991  01:18 PM \PCB\MAIN\TAPE_DRV\
  223. CDISK445.ZIP       160,213  10-01-1991  10:45 AM \PCB\MAIN\TAPE_DRV\
  224.      
  225.                                   ( 5 )
  226.  
  227.    Now that your tape is all set its time to edit your CFG file
  228.    This file can be of any name but if you wish to run tapedoor with
  229.    the /LOCAL option the file TAPE43.CFG must exist.
  230.  
  231.    Below is a example of your tape43.cfg
  232.  
  233. G:\CODES\TAPEDR43\DOOR.SYS
  234. THE U.S.A BBS
  235. RAY
  236. TRACEY
  237. 000000
  238. F
  239. Y
  240. N
  241. G:\BBS\RESTORE\
  242. G:\CODES\TAPEDR43\NODE1\
  243. 10
  244. 0
  245. REM line 1
  246. REM line 2
  247. THIS LINE USED BY TAPEDOOR 4.3 IN MAKEING (RESTORE.BAT)
  248. REM line 4
  249. REM line 5
  250. REM line 6
  251. ------------------------ End of CFG -------------------------------
  252.  
  253. line 1:  Drive and Path to your BBS's System File
  254. line 2:  The name of your BBS
  255. line 3:  Your first name
  256. line 4:  Your last name
  257. line 5:  Registration Code 
  258. line 6:  Restore Files by Volume V or by filename F
  259. Line 7:  Redirect CMS software output to user. Y or N
  260.          By Redirecting the Colorado software to the caller
  261.          you won't see the file being restored but they will.
  262.          Info on who and what's being restored is displayed to you.   
  263. Line 8:  Compare user Bytes left before allowing a restore Y or N
  264. line 9:  Path to place restored files (be sure to end with a \ )
  265.          remember to tell your bbs where to locate the restored files.  
  266. line 10:  Path to DISPLAY FILES (be sure to end with a \ )
  267.           TAPELIST.LST, MAIN, POST, HELP FILES, VOLUME, VOLUME # DISPLAY
  268.           and CMS. the display file are in a self extracting exe called
  269.           display.exe. For single nodes or multi nodes wishing to use the same
  270.           menus and tapelist.lst just extract the files in tapedoors home 
  271.           directory. 
  272.           Remember to copy tapelist.lst to what ever directory you have decided
  273.           to use for your displays.
  274. line 11:  Your last volume # on tape
  275. line 12:  Volume Numbers to Excluded (not searched or displayed) 0 for none
  276. line 13:  RESTORE.BAT Line 1  \          
  277. line 14:  RESTORE.BAT Line 2  \          
  278. line 15:  USED BY TAPE DOOR 4.3          
  279. line 16:  RESTORE.BAT Line 4  \          
  280. line 17:  RESTORE.BAT Line 5  \          
  281. line 18:  RESTORE.BAT Line 6  \
  282.  
  283.    Lines 13, 14, 16, 17, 18 are user defined batch commands. these lines are
  284.    taken  in by tape door  and are used to  make RESTORE.BAT (the  file that
  285.    restores the files) line 15 is used by  tapedoor and will  place the TAPE
  286.    RESTORE commands. Tape  door also make a  second file called  RESTORE.DAT
  287.    that contains  info needed to restore files. CMD.EXE can use this file as
  288.    another  way of restoring  the  file, Read the  CMD.DOC in  the  file
  289.    CMD-LINE.EXE.
  290.  
  291.                                   ( 6 )
  292.  
  293.    Now your  next step should  be how to run  tape door you read the section
  294.    (Features, I hope!)  it stated  what command line option you can use with
  295.    Tape Door.  to run tape  door correctly  it MUST be run from the supplied
  296.    Batch file TAPEDOOR.BAT,  that may be renamed.  below describes  this bat
  297.    file.
  298.  
  299. @ECHO OFF
  300. :START43
  301.   TAPE43 /LOCAL
  302.   REM TAPE43 TAPE43.CFG
  303.   REM TAPE43 NODE1.CFG /5
  304.   REM TAPE43 TAPE43.CFG /FD
  305.   IF ERRORLEVEL 255 GOTO RESTORE
  306.   IF ERRORLEVEL 254 GOTO END
  307.   GOTO END
  308. :RESTORE
  309.   CALL-IT RESTORE.BAT
  310.   DEL LOCKED.
  311.   DEL RESTORE.BAT
  312.   REM DEL RESTORE.DAT
  313.   GOTO START43
  314. :END
  315.  
  316.    We show here a local operation of tape door by the command TAPE43 /LOCAL
  317.    remember with the local option TAPE43.CFG must exist.
  318.   
  319.    The ERRORLEVELs are from  tape door to this  calling batch  file, a 255
  320.    is passed if the user wishes  to restore a file and a errorlevel of 254
  321.    is passed if the called wishes to exit the door.
  322.  
  323.    THE command CALL-IT RESTORE.BAT,  CALL-IT.exe is a exe i made to avoid a
  324.    drop to dos while using the CTTY command in TAPE DOOR V4.2 and just rather
  325.    use it instead of the DOS CALL command. Restore.bat  are lines 13 thru 18
  326.    in the cfg file. tapedoor makes a file  called LOCKED  to stop all other
  327.    nodes from accessing your tape drive while a copy of tapedoor is restoring
  328.    a file, this file must be deleted after restoring a file to allow another
  329.    restore to take place. each time a caller restores  a file tape door will
  330.    pass all the required information needed to restore a file to RESTORE.DAT.
  331.    if restore.dat is found  tapedoor will just  keep appending  the  restore
  332.    data to the file. this could be useful if you would like to restore  your
  333.    files  as a event or  by other means  other then using  restore.bat  info
  334.    passed to tapedoor.dat is as follows.
  335.  
  336.    1   2                  3               4       5
  337.    0 HELP.ZIP \PCB\MAIN\TAPE_DRV\HELP.ZIP 2 G:\BBS\RESTORE\
  338.  
  339.    1 = comport
  340.    2 = filename
  341.    3 = Directory on the tape where the file is
  342.    4 = Volume Number of the file(s)
  343.    5 = where the files will be restored
  344.  
  345.    If you are restoring files by volume then the filename will = *.*
  346.    By using CMD and RESTORE.DAT files can be restored as a event!, freeing
  347.    up online time and restoring files during off-hours. you can even have
  348.    multy copies of tapedoor (TAPELIST.DAT) and use it as a off-line door.
  349.    When a caller requests a file RESTORE.DAT will hold that info into you
  350.    insert the required tape that the user wants the file from.
  351.  
  352.    As you can see by using CMD.EXE and RESTORE.DAT files can be restored
  353.    in a unlimited amount of ways.
  354.  
  355.                                   ( 7 )
  356.  
  357.    Now would be a good time to config you bbs to run the door.
  358.  
  359.                                   ( 8 )
  360.  
  361.    Tapedoor  will display files  from Tapelist.lst  by default, But if you
  362.    have a Text file that contains a file listing of a volume then just name
  363.    this file the same number as the volume!. Remember TAPELIST should  not
  364.    be edited for displaying descriptions.
  365.  
  366.    example: if you have a listing for volume 1 name this file (1)
  367.             if you have a listing for volume 2 name this file (2)
  368.  
  369.    Its that easy, most bbs's have a listing for its files and in most cases
  370.    these file areas are placed on the tape. where the default display has no
  371.    file descriptions (tapelist.lst) you will probley want to use your own.
  372.  
  373.    That should get you up and running.
  374.  
  375.    There are unlimited ways to restore a file by using tape door.
  376.    by a event via CMD.EXE and RESTORE.DAT, when the caller logs off!
  377.    add a ZModem command to your batch file and give the caller the file
  378.    once it has been restored, del the files restored by the caller
  379.    Use other tape drives with Tapedoor other than colorado drives.
  380.    to cut it short what ever a batch file can do! tapedoor can do!
  381.  
  382.    Any input on tapedoor is welcome!, call The U.S.A BBS @ 508-949-6421
  383.    and leave your comments to the sysop (me).
  384.  
  385.    Thanks for Using Tape Door.
  386.